Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions That Modify Movie Properties / Working With Movie Spatial Characteristics

SetMovieMatrix

The SetMovieMatrix function allows your application to set a movie's transformation matrix. The Movie Toolbox uses a movie's matrix to map a movie from its display coordinate system to its graphics world. You can retrieve a movie's matrix with the GetMovieMatrix function, which is described in the next section.

pascal void SetMovieMatrix (Movie theMovie, 
                              const MatrixRecord *matrix);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

matrix

Contains a pointer to the matrix structure for the movie. If you set this parameter to nil, the Movie Toolbox uses the identity matrix.

SPECIAL CONSIDERATIONS

The SetMovieMatrix function does not call your cover functions.

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid

SEE ALSO

The Movie Toolbox provides a number of functions that allow you to manipulate movie matrices. See "Matrix Functions," which begins on page 2-321, for information about these functions.